APPENDIX 1 



import ]ava . lo . ' ; 

import java.net. 

import ]ava.awt.*; 

import ^ava.util.*; 

import Java. applet. */ 

import netscape. javascript.*; 

* Asynchronously pushi.ng pages to browsers. 

* The data can be pushed explicitly or data can be sent 

* by reference using a O'RL. 

* The PushData signifies that it is an applet that 

* is waiting foe push events. 

* <P> 

* <B> PARAMETERS <BR> 

* destwin = Destination Window's Name. <BR> 

* port = Port Number to connect to, default is the port of the originating Web server. 
<BR> 

* desc = One Word Description of PushData applet. <BR> 

*/ 

public class PushData extends Applet implements Runnabie 

( 

protected int port; 
protected Socket socle- 
protected String window = "_new"; 
protected String description; 

protected Thread runner; 
protected boolean threadRunning; 

private DatalnputStream in; 
private DataOutputStream out; 

private static int defaultPort - -1; 

// parameters 

private String targetwindow =■ "destwin"; 
private String portNumber - "port"; 
private String appietDesc * "desc"; 

// Javascript Object 
private JSObject mainwin; 



* Get all the necessary parameters. 

* <ul> 

* <li>port nvimber 

» <li>destination window 

* <li>description 

* </ul> 
•/ 

public void initO 



URL url; 
String str; 



try 

( 

str » getParazneter ( portNurober ); 
if ( str !- null ) 

defaultPort* integer .parseint ( str ); 

} 

catch (NumberFormatException e) { ); 



description « getParameter ( appietDesc ); 



window = this .getParameter ( targeCWindow ); 
mainwin = JSObject.getWindow (this) ; 



* Gets called when loaded. 
V 

public void start {) 

( 

runner = new Thread ( this ) ; 

threadRunning = true; 
runner . start ( ) ; 

} 



* Gets called when browser leaves window. 
*/ 

public void stopO 
{ 

threadRunning = false; 
closeSocket < ) ; 

} 

/' 

* Send/Receive messages from the server. 
V 

public void run <) 

{ 

int avail; 

String data, message; 

while ( threadRunning ) 

{ 

// open the connecnion to the server 
openSocket 0 ; 
if { ! threadRunning ) 
break; 

// notify anyone that the connection is open 
connect ionOpen ( ) ; 

try 

{ 

// open datastreams 

in new DataInputStreani( sock.getlnputStreamO ); 
out - new DataOutputStreaiti( sock. getOutputStreamO ); 

// get the initial connection message 
message « getConnectionMessage () ; 
if ( message !- null ) 

out,writeBytes{ message ); 

// send/receive messages 
for< ; threadRunning ; ) 

{ 

if ( sock — null ) // connection was broken 
break; 

if ( in. aval lab leO — 0 ) 

( 

Thread. sleep( 500 ); // check for data every 1/2 second 
continue; 

} 

data " readAvailableData( in ); 



if ( data == null ) // connection broken 

break; 

processMessage ( data. trim () ) ; 

} 

} 

catch ( Exception e ) 

{ 

System. out . println (e) ; 

} 

// notify that the connection was closed 
connectionCiosed () ; 

} 

} 

* Gets called when browser is closed. 

public void destroy {) 

{ 

oloseSocket O ; 

} 

/** 

* Send a message to the server. 

* Sparam String 
*/ 

public void sendMessage C String msg ) 

{ 

String data, messages- 
try 

{ 

out.writeBytes ( msg ) ; 

> 

catch ( Exception e ) 

{ 

System. out. println ("Send Exception: " + e ) ; 

} 



/** 

* Process the message for this java applet. 

* This can be overridden by other push applets 

* to process the message differently. 

* This method will push a URL into the destination window. 

* If its just data, then we will send data to the window's 

* JavaScript function <b>putText</b>. 

* @parara String 

V 

public void processMessage ( String msg ) 

{ 

int offsets- 
URL url; 
String data; 

offset » msg. lastlndexOf ( ' ' ); 
if ( offset > 0 ) 

data - msg. substring < 0, offset > ; 

else 

data - msg; 



try 

{ 



uri = new URL ( data ) ; 

getAppletContext 0 .showDocument { uri, window ) ; 

} 

catch ( MalformedURLException mue ) 

{ 

Object n args =« { msg }; 
mamwin.call ( "putText", args ); 

} 



* This method will provide th« connection 

* message to be sent to the server when we 

* are connected. This method can be overriden 

* to provide your server specific protocol. 

* @parain String 
V 

public String getConnectionMessage () 

{ 

return "PushData: connect:" + description; 

* Called when connection is opened. 

* Override this method if you want to be notified 

* on connection open. 
♦/ 

protected void connectionOpen () 

{ 
} 

/** 

* Called when connection is closed. 

* Override this method if you want to be notified 

* on connection closed. 
*/ 

protected void connectionClosedO 

{ 
} 

/* 

* open the socket. 
*/ 

protected void openSocketO 

{ 

URL uri; 



uri - getCodeBaaeO ; 

while (threadRunning && uri !- null) // loop until socket is created 

{ 

try 

{ 

if ( defaultPort > 0 ) 
port ■ defaultPort; 

else 

port ■ uri.getPortO ; 
sock - new Socket( url.getHost {) , port ); 
break; 

\ 

catch (Exception e) 

System. out. println< "Error During Socket Open" ); 
System. out. println( e ); 

) 



try 



Thread. sieep(5000) ; 

} 

catch ( IntetruptedException ie ) 



) 

/* 

♦ Close the socket. 
»/ 

protected void cioseSocket () 

{ 

try 

{ 

if ( sock '. = null ) 

{ 

sock. close 0 ; 
sock = null; 

} 

} 

catch (Exception e) 

( 

System. out .println ( "Error During Socket Close" ); 
System. out .println ( e ) ; 

} 



* Read all the data that currently can 

* be read off the pipe. The data, always 

* starts with a length and then the data. 

* Qparam DatalnputStreant 

* (3 return String 
*/ 

private String readAvailafaieOata { DatalnputStream in ) 
throws lOException 

{ 

int bytes, bytesRead-O; 
byte[] b; 

if ( in. available (> > 0 ) 

( 

bytes « in.readlntO ; 

b * new byte [ bytes ] / 
while ( bytesRead < bytes ) 

I 

bytesRead ■*■«- in.read( b, bytesRead, bytes-bytesRead ) 

> 

} 

else 

return null; 
return new String ( b ) ; 



